LGF_Random_DInt (FC / V3.0.1)


Author: Siemens Digital Industries

Short description

This function generates a random value with each call.
The random number has the data type DInt.

Block Interface

LGF_Random_DInt (FC)
   Ret_Val  DInt
    
   error  Bool
    
   status  Word
    
   subfunctionStatus  Word
    
   

Output parameter

IdentifierData typeDescription
Ret_ValDIntRandom number in the DInt range
errorBoolFALSE: No error
TRUE: An error occurred during the execution of the FB
statusWord16#0000-16#7FFF: Status of the FB
16#8000-16#FFFF: Error identification (see following Table)
subfunctionStatusWordStatus or return value of called FB's, FC's and system blocks

Status & Error codes

Code / ValueIdentifier / Description
16#0000STATUS_FINISHED_NO_ERROR
Execution finished without errors
16#8600ERR_RD_SYS_T
Error in `RD_SYS_T` command - check `subFunctionStatus` code

Functional description

Note
The status of called commands is output in subFunctionStatus. In this case, the output value in status indicates which command caused the error. In this case, refer to the TIA Portal Online Help section for information on the respective commands.

The function generates random values in the range:
-2147483648 ≤ ReturnVal ≤ 2147483647.

The random value is formed from the nanoseconds of the current system time of the CPU. The byte order of this value is inverted and then converted to DInt.

Change log

Version & DateChange description
01.00.00Siemens Industry Presales Support
13.11.2019First release
copied from "LGF_Random_Real"
03.00.00Simatic Systems Support
23.04.2020Set version to V3.0.0, harmonize the version of the whole library
03.00.01Simatic Systems Support
04.02.2021Insert documentation